chore(deprecation): move removal notices to 0.19 and mark the legacy controller API - #4162
Open
Apollon77 wants to merge 2 commits into
Open
chore(deprecation): move removal notices to 0.19 and mark the legacy controller API#4162Apollon77 wants to merge 2 commits into
Apollon77 wants to merge 2 commits into
Conversation
…controller API Deprecation notices that announced removal in 0.18 now announce 0.19, and the surfaces that were deprecated without a removal version get one where the decision is settled. - @project-chip/matter.js: every exported class, type, enum and function of the legacy controller API is now marked deprecated for 0.19 (CommissioningController, PairedNode, MatterController, PaseCommissioner, the controller stores, cluster clients, InteractionClient and the device layer). Only the DecodedDataReport adapters are excluded - they are the canonical target of the @matter/protocol decoder notices. - @matter/types: the ClusterType() factory compat layer (RetiredClusterType, RetiredElements, the TLV element reverse mapping) and the generated Cluster / Complete / <Name>Cluster aliases are marked for 0.19. Cluster definitions regenerated accordingly. - @matter/protocol: the legacy ClusterType command request surface and SessionManager.owner are marked for 0.19. - @matter/node: StructManager.assertDirectReadAuthorized() and the direct-read authorization mechanism behind it are removed - the export had no callers and AUTHORIZE_READ plus propertyAccessControls existed only to serve it. Also fixes a mistyped @deprected tag on a PeerConnectionOptions member, so that member is now actually flagged, and refreshes the 0.8 migration guide intro, which still claimed the legacy device API was pending removal (it went in 0.13) and that the controller API was unchanged. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Contributor
There was a problem hiding this comment.
Pull request overview
This PR updates deprecation messaging across the monorepo to consistently announce removal in 0.19, expands deprecation coverage for the legacy controller surface (notably in @project-chip/matter.js), and removes an unused direct-read authorization path in @matter/node.
Changes:
- Bump “scheduled for removal” deprecation notices from 0.18 → 0.19 across protocol decoders and ClusterType compatibility surfaces.
- Mark legacy controller API exports as deprecated with a consistent “scheduled for removal in 0.19” message.
- Remove unused
StructManager.assertDirectReadAuthorized()and its backing direct-read authorization machinery.
Reviewed changes
Copilot reviewed 41 out of 182 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| support/codegen/src/clusters/generate-cluster.ts | Updates generated cluster alias deprecation text to removal in 0.19. |
| packages/types/src/tlv/TlvWrapper.ts | Marks old ClusterType compat element mapping as removal in 0.19. |
| packages/types/src/tlv/TlvString.ts | Marks old ClusterType compat element mapping as removal in 0.19. |
| packages/types/src/tlv/TlvSchema.ts | Clarifies TLV reverse mapping deprecation/removal timing (0.19). |
| packages/types/src/tlv/TlvObject.ts | Marks old ClusterType compat element mapping as removal in 0.19. |
| packages/types/src/tlv/TlvNumber.ts | Marks old ClusterType compat element mapping as removal in 0.19. |
| packages/types/src/tlv/TlvNullable.ts | Marks old ClusterType compat element mapping as removal in 0.19. |
| packages/types/src/tlv/TlvBoolean.ts | Marks old ClusterType compat element mapping as removal in 0.19. |
| packages/types/src/tlv/TlvArray.ts | Marks old ClusterType compat element mapping as removal in 0.19. |
| packages/types/src/clusters/zone-management.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/window-covering.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/wi-fi-network-management.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/wi-fi-network-diagnostics.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/web-rtc-transport-requestor.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/web-rtc-transport-provider.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/web-rtc-transport-definitions.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/water-tank-level-monitoring.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/water-heater-mode.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/water-heater-management.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/wake-on-lan.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/valve-configuration-and-control.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/user-label.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/unit-localization.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/total-volatile-organic-compounds-concentration-measurement.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/tls-client-management.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/tls-certificate-management.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/time-synchronization.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/time-format-localization.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/thread-network-directory.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/thread-network-diagnostics.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/thread-border-router-management.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/thermostat.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/thermostat-user-interface-configuration.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/temperature-measurement.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/temperature-control.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/temperature-alarm.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/target-navigator.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/switch.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/soil-measurement.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/software-diagnostics.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/smoke-co-alarm.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/service-area.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/scenes-management.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/rvc-run-mode.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/rvc-operational-state.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/rvc-clean-mode.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/resource-monitoring.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/relative-humidity-measurement.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/refrigerator-and-temperature-controlled-cabinet-mode.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/refrigerator-alarm.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/radon-concentration-measurement.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/push-av-stream-transport.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/pump-configuration-and-control.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/pressure-measurement.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/power-topology.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/power-source.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/power-source-configuration.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/pm25-concentration-measurement.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/pm10-concentration-measurement.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/pm1-concentration-measurement.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/ozone-concentration-measurement.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/oven-mode.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/oven-cavity-operational-state.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/ota-software-update-requestor.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/ota-software-update-provider.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/operational-state.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/operational-credentials.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/on-off.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/occupancy-sensing.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/nitrogen-dioxide-concentration-measurement.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/network-commissioning.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/mode-select.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/mode-base.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/microwave-oven-mode.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/microwave-oven-control.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/meter-identification.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/messages.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/media-playback.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/media-input.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/low-power.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/localization-configuration.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/level-control.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/laundry-washer-mode.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/laundry-washer-controls.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/laundry-dryer-controls.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/label.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/keypad-input.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/joint-fabric-datastore.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/joint-fabric-administrator.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/illuminance-measurement.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/identify.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/icd-management.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/hepa-filter-monitoring.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/groups.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/groupcast.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/group-key-management.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/general-diagnostics.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/general-commissioning.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/formaldehyde-concentration-measurement.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/flow-measurement.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/fixed-label.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/fan-control.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/ethernet-network-diagnostics.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/energy-preference.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/energy-evse.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/energy-evse-mode.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/electrical-power-measurement.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/electrical-grid-conditions.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/electrical-energy-measurement.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/ecosystem-information.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/door-lock.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/dishwasher-mode.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/dishwasher-alarm.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/diagnostic-logs.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/device-energy-management.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/device-energy-management-mode.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/descriptor.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/content-launcher.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/content-control.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/content-app-observer.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/concentration-measurement.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/commodity-tariff.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/commodity-price.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/commodity-metering.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/commissioner-control.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/color-control.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/closure-dimension.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/closure-control.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/chime.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/channel.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/carbon-monoxide-concentration-measurement.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/carbon-dioxide-concentration-measurement.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/camera-av-stream-management.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/camera-av-settings-user-level-management.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/bridged-device-basic-information.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/boolean-state.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/boolean-state-configuration.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/binding.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/basic-information.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/audio-output.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/application-launcher.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/application-basic.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/ambient-context-sensing.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/alarm-base.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/air-quality.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/administrator-commissioning.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/activated-carbon-filter-monitoring.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/actions.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/account-login.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/clusters/access-control.d.ts | Generated cluster alias deprecation text updated to 0.19. |
| packages/types/src/cluster/RetiredElements.ts | Updates deprecated ClusterType compat layer text to 0.19. |
| packages/types/src/cluster/RetiredClusterType.ts | Updates deprecated ClusterType compat layer text to 0.19. |
| packages/types/src/cluster/ClusterType.ts | Updates legacy ClusterType factory and compat shim deprecation/removal guidance to 0.19. |
| packages/protocol/src/session/SessionManager.ts | Marks legacy owner accessor/context as removal in 0.19. |
| packages/protocol/src/interaction/EventDataDecoder.ts | Updates decoder-related deprecation notices to removal in 0.19. |
| packages/protocol/src/interaction/DecodedDataReport.ts | Updates data report deprecation notices to removal in 0.19. |
| packages/protocol/src/interaction/AttributeDataDecoder.ts | Updates decoder-related deprecation notices to removal in 0.19. |
| packages/protocol/src/action/request/Specifier.ts | Marks legacy ClusterType command specifier as removal in 0.19. |
| packages/protocol/src/action/request/Invoke.ts | Marks legacy ClusterType command request surface as removal in 0.19. |
| packages/nodejs-shell/README.md | Fixes typo in documentation (“matter,js” → “matter.js”). |
| packages/node/src/node/client/ClientNodeInteraction.ts | Updates deprecation notice for legacy local-state accessor. |
| packages/node/src/behavior/state/managed/values/StructManager.ts | Removes unused direct-read authorization path and related import/symbols. |
| packages/matter.js/src/PaseCommissioner.ts | Marks legacy commissioner class as deprecated for removal in 0.19. |
| packages/matter.js/src/MatterController.ts | Marks legacy controller types and class as deprecated for removal in 0.19. |
| packages/matter.js/src/LegacyControllerStore.ts | Marks legacy controller store as deprecated for removal in 0.19. |
| packages/matter.js/src/device/TypeHelpers.ts | Marks legacy controller type helper as deprecated for removal in 0.19. |
| packages/matter.js/src/device/PairedNode.ts | Marks legacy controller node APIs as deprecated for removal in 0.19. |
| packages/matter.js/src/device/Endpoint.ts | Marks legacy endpoint surface as deprecated for removal in 0.19. |
| packages/matter.js/src/device/DeviceTypes.ts | Marks legacy device type surface as deprecated for removal in 0.19. |
| packages/matter.js/src/device/DeviceInformation.ts | Marks legacy device information surface as deprecated for removal in 0.19. |
| packages/matter.js/src/device/Device.ts | Marks legacy device classes as deprecated for removal in 0.19. |
| packages/matter.js/src/device/ComposedDevice.ts | Marks legacy composed device surface as deprecated for removal in 0.19. |
| packages/matter.js/src/device/Aggregator.ts | Marks legacy aggregator surface as deprecated for removal in 0.19. |
| packages/matter.js/src/ControllerStore.ts | Marks legacy controller store/interface as deprecated for removal in 0.19. |
| packages/matter.js/src/CommissioningController.ts | Marks legacy commissioning controller surface as deprecated for removal in 0.19. |
| packages/matter.js/src/cluster/client/InteractionClient.ts | Marks legacy interaction client surface as deprecated for removal in 0.19 and fixes deprecated tag spelling. |
| packages/matter.js/src/cluster/client/EventClient.ts | Marks legacy event client surface as deprecated for removal in 0.19. |
| packages/matter.js/src/cluster/client/ClusterClientTypes.ts | Marks legacy cluster client type surfaces as deprecated for removal in 0.19. |
| packages/matter.js/src/cluster/client/ClusterClient.ts | Marks legacy cluster client functions as deprecated for removal in 0.19. |
| packages/matter.js/src/cluster/client/AttributeClient.ts | Marks legacy attribute client surface as deprecated for removal in 0.19. |
| docs/MIGRATION_GUIDE_08.md | Updates migration guide intro to reflect prior removal and legacy controller deprecation timeline. |
| CHANGELOG.md | Adds WIP changelog entries summarizing the 0.19 deprecation updates and StructManager removal. |
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Contributor
|
Tick the box to add this pull request to the merge queue (same as
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Deprecation notices that announced removal in 0.18 now announce 0.19, and surfaces that were deprecated without a removal version get one where the decision is settled.
What changed
@project-chip/matter.js— legacy controller API fully marked. Every exported class, type, enum and function now carries@deprecated Scheduled for removal in 0.19. Part of the legacy controller API superseded byClientNodein@matter/node.—CommissioningControllerand its option types,PairedNode,MatterController,PaseCommissioner, the controller stores, the cluster clients (ClusterClient,AttributeClient,EventClient,ClusterClientTypes),InteractionClient/InteractionClientProvider, and the device layer (Endpoint,Device,Aggregator,DeviceTypes, …). Previously only a handful of individual members were flagged, so IDEs gave no signal on the classes and types themselves.Deliberately not marked:
cluster/client/DecodedDataReport.ts, which is the canonical target of the@matter/protocoldecoder notices, andgetDeviceTypeDefinitionFromModelByCode, which is the documented replacement for its deprecated neighbour.@matter/types— legacy cluster handling. TheClusterType()factory compat layer (RetiredClusterType,RetiredElements, the TLVelementreverse mapping and thePart of old ClusterType() compat layermarkers) plus the generatedCluster/Complete/<Name>Clusteraliases and theClusterType.WithCompatwith()shim now state 0.19. Cluster definitions regenerated (npm run generate-clusters); that diff is deprecation text only.@matter/protocol. The 0.18 decoder notices become 0.19, and the legacyClusterTypecommand request surface (Invoke.LegacyCommandRequest,Specifier.ClusterTypeCommand) plusSessionManager.ownerare stamped.@matter/node— dead code removed.StructManager.assertDirectReadAuthorized()had no callers, andAUTHORIZE_READpluspropertyAccessControlsexisted only to serve it, so the whole direct-read authorization path is gone along with the then-unusedImplementationErrorimport.Two incidental fixes
PeerConnectionOptionshad a mistyped@deprectedtag, so that member was never actually flagged by tooling. Now spelled correctly and stamped.docs/MIGRATION_GUIDE_08.mdintro still claimed the legacy device API "will be deprecated and removed in upcoming releases" (it was removed in 0.13) and that "the Controller API is still the same as before". Both refreshed, with the pointer toServerNode.peers/ClientNode.Left undated on purpose
Storage driver renames, the legacy
Loggerdestination API, migration-only readers for legacy persisted formats, and a set of one-offs are tracked as 0.19 candidates outside the code, because each needs a judgement call (oldest supported upgrade path, downstream reach) rather than a committed deadline. Stating 0.19 in those comments would promise something not yet decided.Test plan
npm run build -- --clean✓npm run lint✓npm run format-verify✓npm test(full suite) ✓ — 10 packages, all ESM/CJS/Web variants, zero failures;@matter/node1557/1557 covers theStructManagerdeletion, which is the only functional change in the diff🤖 Generated with Claude Code